Usando GitHub com R e RStudio
🚀 Introdução
Bem-vindo! Este tutorial foi feito para quem nunca usou Git ou GitHub, especialmente no contexto de ciência de dados com R.
🎯 O que você vai aprender
- O que são Git e GitHub e por que usá-los;
- Como instalar e configurar o ambiente de trabalho no RStudio;
- Como criar projetos no GitHub e no RStudio;
- Como salvar e compartilhar seu trabalho usando versionamento.
🧠 Entendendo o Git e o GitHub
📦 O que é Git?
Git é como uma máquina do tempo para o seu projeto. Ele salva versões do seu código, permitindo que você volte atrás, colabore e mantenha tudo organizado.
☁️ O que é GitHub?
GitHub é uma plataforma online que guarda seus projetos Git e permite que você trabalhe com outras pessoas.
🧰 Configurando o ambiente
Faça o download conforme seu sistema operacional e siga as instruções de instalação.
Depois, vá até o menu:
Tools > Global Options > Git/SVN.Se o campo Git executable estiver vazio ou com erro, será necessário configurar o caminho do executável do Git.
Localize o caminho correto e preencha o campo Git executable:
- Windows:
C:/Program Files/Git/bin/git.exe; ou - MacOS/Linux:
/usr/bin/git(em geral).
- Windows:
Clique em OK para salvar as configurações.
Abra o terminal do RStudio e configure seu nome e email do Git:
git config --global user.name "Seu Nome" git config --global user.email "email@example.com"Abra o terminal integrado do RStudio (
Tools > Terminal > New Terminal). Devem ficar visiveis dois elemento visuais: o menu suspenso “Git/Controle” de versão e a guia “Git/Controle de versão”.
📘 Conceitos fundamentais
- Repositório: pasta do projeto com controle de versão
- Clone: copiar um repositório remoto para o local
- Fork: criar uma cópia de um repositório para modificar
- Commit: um registro de alterações
- Push: enviar alterações para o GitHub a partir do RStudio
- Pull: baixar alterações do GitHub para o RStudio
🔗 Conectando o GitHub ao RStudio
No GitHub
- Crie um novo repositório e dê um nome significativo, que identifique a natureza do projeto.
- Marque a opção “Add a README”. Isso cria um arquivo README.md para descrever o projeto.
- Escolha a licença (opcional, mas recomendado).
- Clique em “Create repository”.
No RStudio
- Crie um novo projeto de controle de versão:
File > New Project > Version Control > Git. - Cole a URL do repositório criado no GitHub.
- Clone o projeto localmente:
- Selecione a pasta onde o projeto será salvo.
- Marque a opção “Create a git repository”.
- Escolha o diretório onde o projeto será salvo.
- Clique em “Create Project”. Isso cria um novo projeto RStudio vinculado ao repositório GitHub.
✍️ Trabalhando com Git no RStudio
- Trabalhe no projeto, adicionando arquivos, fazendo análises.
- Depois vá para a aba “Git”. Você verá os arquivos modificados, novos arquivos e arquivos deletados.
- Selecione os arquivos que deseja incluir no commit.
- Clique em “Commit” para abrir a janela de commit.
- Adicione uma mensagem de commit descritiva.
- Clique em “Commit” para registrar as alterações localmente.
- Para enviar as alterações para o GitHub, clique em “Push”.
- Para baixar as alterações do GitHub, clique em “Pull”.
🧪 Atividade Prática
Você vai clonar o repositório desse tutorial e fazer algumas modificações:
- Clone o repositório tutorial GitHub.
- Crie um arquivo
resumo.Rcom o código:
summary(iris)- Salve o arquivo
resumo.Rno diretório do repositório clonado. - Vá para a aba “Git” no RStudio, você verá o arquivo
resumo.Rlistado como modificado. - Selecione o arquivo
resumo.Re clique em “Commit”. - Escreva uma mensagem de commit, como “Adiciona resumo da base iris”.
- Clique em “Commit” para registrar as alterações localmente.
- Clique em “Push” para enviar as alterações para o GitHub.
- Verifique no GitHub se o arquivo
resumo.Rfoi adicionado corretamente.
🧠 Dicas e boas práticas
- Sempre trabalhe em um repositório clonado localmente;
- Sempre faça commits frequentes e significativos;
- Use mensagens de commit claras e descritivas;
- Mantenha o repositório organizado com pastas para scripts, dados e resultados;
- Sempre faça pull antes de começar a trabalhar para evitar conflitos;
- Use o arquivo
.gitignorepara excluir arquivos temporários ou desnecessários do controle de versão; - Mantenha o README atualizado com informações sobre o projeto, como instalação, uso e contribuições.